home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / cpycn310.zip / COPYCON.DOC next >
Text File  |  1989-05-15  |  20KB  |  535 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                      CopyCon
  29.  
  30.  
  31.                                   Version 3.10
  32.                                     May 1989
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                        by
  49.                                John E. Bean, P.E.
  50.                               Data Acquisition Inc.
  51.                                1701 Broadway #156
  52.                               Vancouver, Wa. 98663
  53.  
  54.  
  55.  
  56.  
  57.                                   INTRODUCTION
  58.  
  59.  
  60.      CopyCon is a program to be used in lieu of the DOS command COPY CON.  I
  61.      have  used COPY CON numerous times in creating batch files and  miscel-
  62.      laneous small text files. 
  63.  
  64.      I have experienced many frustrating moments using COPY CON.  I have ac-
  65.      cidently overwritten existing files.  I have mistyped commands only  to
  66.      notice  them while entering the next line.  I have also wanted to  have
  67.      graphic boxes in my batch files.
  68.  
  69.      CopyCon alleviates all of the above problems.  It checks to see if  the
  70.      specified file exists,  and if it does CopyCon provides either  loading
  71.      the  existing  file  or allows the existing  file  to  be  overwritten.
  72.      CopyCon  also  has full screen editing capability and built  in  Macros
  73.      which aids in creating files.
  74.  
  75.      CopyCon  was written in Turbo Pascal 5.0 using routines from Turbo  5.0
  76.      Professional.  The help screens were designed using a screen  generator
  77.      "SayWhat!".
  78.  
  79.      CopyCon  is  so easy to use that this manual is not necessary  but  the
  80.      following sections will briefly discuss how to use CopyCon.
  81.  
  82.  
  83.  
  84.                                    LIMITATIONS
  85.  
  86.      I  have designed CopyCon for typical batch files and small text  files.
  87.      It  is not designed to be a text editor!  If you need a text  editor  I
  88.      have written a text editor "LIMA". 
  89.  
  90.      There are two main limitations that I designed into this program.  They
  91.      are:
  92.  
  93.                * The  maximum length of a text line is 80  charac-
  94.                  ters.
  95.                * There are no block functions.  You can only  copy
  96.                  the current line to next line.
  97.  
  98.      These  limitations  were  done to distinguish  the  difference  between
  99.      CopyCon and a text editor.   
  100.  
  101.  
  102.  
  103.                                  GETTING STARTED
  104.  
  105.      CopyCon is comprised of two (2) files. They are:
  106.           * Copycon.exe - The executable program.
  107.           * Copycon.doc - This documentation. 
  108.  
  109.      Start  CopyCon  by  issuing the following command at  the  DOS  prompt: 
  110.                               A:>CopyCon (filename).
  111.  
  112.      As you can see this is identical to using the DOS command COPY CON  ex-
  113.      cept there is not a space between Copy and Con. The user is responsible
  114.      for providing a valid filename.
  115.  
  116.      Once the program is loaded into memory,  the program will check to  see
  117.      if your computer has a color graphics card. If it does the program will
  118.      be displayed in color.  You can force CopyCon to be displayed in  black
  119.      and  white by typing in "/bw"  AFTER the filename on the command  line.
  120.      For  example;  if you wish to create a batch file named  "CPY.BAT"  and
  121.      have CopyCon be in black and white the following is the correct syntax.
  122.  
  123.                               A:>CopyCon  CPY.BAT /bw
  124.  
  125.      Next the screen will be cleared,  ">CopyCon  (filename)"  will be  dis-
  126.      played in the upper left hand corner.  Several other items will be dis-
  127.      played to the right of the file name. They are:
  128.           * F1 - Help:   A  help  menu is available simply  by  de   
  129.                          pressing  the F1 function key.  The  help    
  130.                          menu  provides  information  on   editing    
  131.                          keys and several batch file command.
  132.           * F2 - Macros: Depressing  the  F2  function  key   will    
  133.                          display the predefined Macros.
  134.           * 1,1:         The  y,x  position of the cursor.  The  y    
  135.                          position is the FILE LINE position.
  136.           * INS:         If  the insert mode is ON then  INS  will    
  137.                          be displayed. 
  138.           * [max line]:  The number displayed inside the "[ ]"  is     
  139.                          the  maximum  number of lines  your  file     
  140.                          can  have.  For  a  640K  machine,   this     
  141.                          should be around 5000.
  142.  
  143.      If the file entered on the command line exists,  a pop up menu will ap-
  144.      pear offering the following choices:
  145.           * LOAD:        This  option will load the existing  file    
  146.                          and  CopyCon  can be used to  modify  the    
  147.                          file.
  148.           * OVERWRITE:   This  option will overwrite the  existing    
  149.                          file. 
  150.           * EXIT:        This option will abort CopyCon.
  151.  
  152.      The cursor will be located at the left hand column  of your screen. You
  153.      are now ready to create/edit your file.
  154.  
  155.  
  156.  
  157.                                 EDITING COMMANDS
  158.  
  159.      CopyCon  provides simple editing commands. These commands can  be  dis-
  160.      played  while  editing through the Help Menu which is accessed  by  de-
  161.      pressing the F1 function key.  The editing commands can be broken  into
  162.      the following sections.
  163.  
  164.      CURSOR PAD KEYS:
  165.        Up Arrow Key:
  166.           Depressing the Up arrow key will move the cursor to  the
  167.           previous line. Depressing the Up arrow key while on line
  168.           one will result in the display of an error message.
  169.  
  170.        Down Arrow Key:
  171.           Depressing  the Down arrow key will move the  cursor  to
  172.           the  next line.  Depressing the Down arrow key while  on
  173.           the  last line entered will result in the display of  an
  174.           error message.
  175.  
  176.        Left Arrow Key:
  177.           Depressing  the Left arrow key will move the cursor  one
  178.           position left on the current line.  Depressing the  Left
  179.           arrow  key  while at the leftmost column on  the  screen
  180.           will result in the display of an error message.
  181.  
  182.        Right Arrow Key:
  183.           Depressing the Right arrow key will move the cursor  one
  184.           position right on the current line. Depressing the Right
  185.           arrow  key while at the rightmost column on  the  screen
  186.           will result in the display of an error message.
  187.  
  188.        Home Key:
  189.           Depressing  the  HOME key will move the  cursor  to  the
  190.           leftmost position on the current line.
  191.  
  192.        End Key:
  193.           Depressing  the  END  key will move the  cursor  to  the
  194.           rightmost position on the current line.
  195.  
  196.        Tab Key:
  197.           Depressing the TAB key will move the cursor right  eight
  198.           (8) spaces.
  199.  
  200.        Shift Tab Key:
  201.           Simultaneously depressing the Shift key and the Tab  key
  202.           will move the cursor left eight (8) spaces.
  203.  
  204.        Ctrl Home Key:
  205.           Simultaneously depressing the Ctrl key and the HOME  key
  206.           will move the cursor to the top of the screen.
  207.  
  208.        Ctrl End Key:
  209.           Simultaneously  depressing the Ctrl key and the END  key
  210.           will move the cursor to the bottom of the screen.
  211.  
  212.        Ctrl PgDn Key:
  213.           Simultaneously depressing the Ctrl key and the PgDn  key
  214.           will move the cursor to the end of the file. If the cur-
  215.           sor  is already at the end of the file an error  message
  216.           will be displayed.
  217.  
  218.        Ctrl PgUp Key:
  219.           Simultaneously depressing the Ctrl key and the PgUp  key
  220.           will move the cursor to the top of the file. If the cur-
  221.           sor  is already at the top of the file an error  message
  222.           will be displayed.
  223.  
  224.        Ins Key:
  225.           Depressing  the INS key will toggle the Insert  Mode  on
  226.           and off.  If the Insert Mode is on,  "INS"  will be dis-
  227.           played on the top line in inverse video.
  228.  
  229.        Del Key:
  230.           Depressing  the DEL key will delete the character  und